home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / text / hyper / hsc.readme < prev    next >
Text File  |  1998-02-07  |  11KB  |  253 lines
  1. Short:    V0.916; html-preprocessor (bin+docs)
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  0.916
  5. Type:     text/hyper
  6. Kurz:     html-Vorarbeiter
  7. Requires: AmigaOS 2.04, 68020, 2MB, UserIQ>50
  8.  
  9. TITLE
  10.  
  11.   hsc - html sucks completely
  12.  
  13. VERSION 
  14.  
  15.   0.916
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   Hsc is a developer tool for html-projects.
  24.  
  25.   It can be used on any html file and creates a new html file as
  26.   output. In the input file, you may use an extended syntax based on
  27.   html, but which also allows extensions like macros, conditionals and
  28.   more.
  29.  
  30.   It's mainly intended to create and maintain larger html projects. As
  31.   a CLI-only tool, it can be used together with `make', and a
  32.   dependency generator is included.
  33.  
  34.   Hsc is *not* a tool to make html easier for beginners; it's a tool
  35.   to make html a bit less painful and brain-damaged for people who
  36.   already know how to work with it.
  37.  
  38. FEATURES
  39.  
  40.   - macros (implemented as additional tags)
  41.   - conditionals (if/else/elseif)
  42.   - expressions, supporting
  43.     - string concatenation and comparison,
  44.     - import of environment variables
  45.     - current time
  46.     - size of files
  47.   - special tags to
  48.     - include files (also verbatim text)
  49.     - execute shell commands (and include output)
  50.     - comment in a reasonable way
  51.   - for local links, checks if file/id exists
  52.   - project relative URIs
  53.   - replaces special characters by entities
  54.   - evaluates attributes for image size (PNG/jfif/gif)
  55.   - strips comments and specified tags
  56.   - strips useless white spaces
  57.   - replaces icon entities by images
  58.   - performs a basic syntax- and structure check
  59.   - easy to extend syntax definition format
  60.   - maintains a project file
  61.   - dependency generator for Makefiles included
  62.   - tool to examine/manipulate project files included
  63.  
  64. NEW FEATURES
  65.  
  66.   - now aborts if a specifiable number of errors occurred
  67.   - as usually, some minor bugfixes and improvements
  68.   - made Postscript version of manual available in a separate archive
  69.  
  70. SPECIAL REQUIREMENTS
  71.  
  72.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of w3-browser
  73.   and ASCII editor.
  74.  
  75.   For larger projects, 4MB of memory and 68040 are recommended.
  76.  
  77.   Different to many other html-tools, hsc requires an user-IQ > 50. You
  78.   should also know how to work with the CLI and how to write
  79.   Makefiles. You should already have made some experiences with macro
  80.   processors and some programming language (Rexx should suffice).
  81.  
  82. AVAILABILITY
  83.  
  84.   - Every Aminet-mirror, file "text/hyper/hsc.lha", for example:
  85.  
  86.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha
  87.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-source.lha
  88.     ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-ps.lha
  89.  
  90.   - http://www.giga.or.at/~agi/hsc/
  91.  
  92. PRICE
  93.  
  94.   Freeware.
  95.  
  96. DISTRIBUTABILITY
  97.  
  98.   Distributed under GNU General Public License.
  99.  
  100. SOURCE CODE
  101.  
  102.   ANSI-C source code is available in a separate archive named
  103.   `hsc-source.lha'.
  104.  
  105.  
  106. ============================= Archive contents =============================
  107.  
  108. Original  Packed Ratio    Date     Time    Name
  109. -------- ------- ----- --------- --------  -------------
  110.       37      37  0.0% 12-Jan-98 05:39:06  FILE_ID.DIZ
  111.      628     276 56.0% 12-Nov-97 22:51:48  hsc.info
  112.    30309   11691 61.4% 12-Jan-98 03:26:34 +CHANGES
  113.      463     242 47.7% 31-May-97 02:47:38 +CHANGES.info
  114.    17982    6993 61.1% 26-Jun-95 08:31:52 +COPYING
  115.      463     242 47.7% 31-May-97 02:47:38 +COPYING.info
  116.      628     269 57.1% 02-Jun-97 04:25:02 +docs-source.info
  117.      436     262 39.9% 10-Oct-97 02:01:02 +README
  118.      463     238 48.5% 02-Jun-97 04:24:52 +README.info
  119.      628     271 56.8% 31-May-97 02:47:38 +docs.info
  120.     5109    2385 53.3% 12-Jan-98 04:33:18 +about.html
  121.     6772    3010 55.5% 12-Jan-98 04:40:28 +author.html
  122.     6225    2841 54.3% 12-Jan-98 04:39:50 +bugs.html
  123.     4228    2003 52.6% 12-Jan-98 04:40:36 +changes.html
  124.     2177    1049 51.8% 12-Jan-98 04:38:40 +copy.html
  125.     4065    1621 60.1% 12-Jan-98 04:38:44 +distrib.html
  126.     2385    1078 54.8% 12-Jan-98 04:37:22 +envvar.html
  127.     2300    1041 54.7% 12-Jan-98 04:34:56 +examples.html
  128.     6787    2574 62.0% 12-Jan-98 04:40:24 +assign.html
  129.     1832     821 55.1% 12-Jan-98 04:36:52 +checkuri.html
  130.     9800    3659 62.6% 12-Jan-98 04:40:04 +exec.html
  131.     7022    2475 64.7% 12-Jan-98 04:39:40 +expressions.html
  132.     6282    2793 55.5% 12-Jan-98 04:38:56 +getsize.html
  133.     4717    1762 62.6% 12-Jan-98 04:40:08 +if.html
  134.     8900    3767 57.6% 12-Jan-98 04:40:12 +prefs.html
  135.     2208    1086 50.8% 12-Jan-98 04:35:26 +rplcent.html
  136.    13155    3755 71.4% 12-Jan-98 04:39:12 +spcattr.html
  137.    13272    4905 63.0% 12-Jan-98 04:39:22 +spctags.html
  138.     3913    1692 56.7% 12-Jan-98 04:39:16 +strip.html
  139.     1894     882 53.4% 12-Jan-98 04:40:16 +syntax.html
  140.     5920    2447 58.6% 12-Jan-98 04:38:48 +uris.html
  141.     5934    2357 60.2% 12-Jan-98 04:38:16 +fileargs.html
  142.     7206    3167 56.0% 12-Jan-98 04:38:24 +future.html
  143.      103     103  0.0% 06-Jun-97 23:32:02 +austria.gif
  144.      138     138  0.0% 14-Jan-96 17:27:46 +back.gif
  145.      190     190  0.0% 14-Jan-96 17:20:08 +copy.gif
  146.      140     140  0.0% 06-Jun-97 23:31:34 +english.gif
  147.      638     638  0.0% 26-May-96 02:10:44 +hsc.gif
  148.      170     170  0.0% 14-Jan-96 17:14:34 +index.gif
  149.      176     176  0.0% 14-Jan-96 17:14:44 +main.gif
  150.      189     189  0.0% 14-Jan-96 17:15:02 +next.gif
  151.      347     347  0.0% 12-Oct-96 18:51:36 +niceguy.gif
  152.     8650     713 91.7% 10-Jan-98 18:05:26 +niceguy.ps
  153.      168     168  0.0% 14-Jan-96 17:28:12 +noback.gif
  154.      211     211  0.0% 14-Jan-96 17:20:36 +nocopy.gif
  155.      200     200  0.0% 14-Jan-96 17:15:28 +noindex.gif
  156.      201     201  0.0% 11-Jan-98 16:39:54 +nomain.gif
  157.      212     212  0.0% 14-Jan-96 17:15:52 +nonext.gif
  158.      213     213  0.0% 15-Jul-96 23:44:28 +noprev.gif
  159.      188     188  0.0% 14-Jan-96 17:16:08 +prev.gif
  160.      111     111  0.0% 06-Jun-97 23:32:22 +teutsch.gif
  161.      141     141  0.0% 04-Nov-95 02:20:36 +up.gif
  162.     7585    2763 63.5% 12-Jan-98 04:40:50 +index.html
  163.      463     245 47.0% 04-Mar-97 04:41:40 +index.html.info
  164.     4806    2115 55.9% 12-Jan-98 04:40:00 +install.html
  165.     5045    1831 63.7% 12-Jan-98 04:33:52 +attrib.html
  166.     4695    1712 63.5% 12-Jan-98 04:38:38 +flag.html
  167.     9529    3571 62.5% 12-Jan-98 04:38:20 +macros.html
  168.    27624    8788 68.1% 12-Jan-98 04:38:32 +messages.html
  169.    12977    5014 61.3% 12-Jan-98 04:37:52 +options.html
  170.     6333    2783 56.0% 12-Jan-98 04:39:46 +others.html
  171.     6929    3021 56.4% 12-Jan-98 04:39:56 +ports.html
  172.     3530    1446 59.0% 12-Jan-98 04:39:06 +hscdepp.html
  173.     2344    1077 54.0% 12-Jan-98 04:40:44 +hscpaltrow.html
  174.     7278    2658 63.4% 12-Jan-98 04:38:52 +hscpitt.html
  175.    10691    3909 63.4% 12-Jan-98 04:36:20 +index.html
  176.     6693    2957 55.8% 12-Jan-98 04:34:26 +make.html
  177.     4819    1970 59.1% 12-Jan-98 04:39:04 +makefile.html
  178.     3106    1308 57.8% 12-Jan-98 04:39:00 +prjfile.html
  179.     8903    3543 60.2% 12-Jan-98 04:40:40 +questions.html
  180.     4357    1922 55.8% 12-Jan-98 04:39:26 +related.html
  181.     3692    1735 53.0% 12-Jan-98 04:40:20 +require.html
  182.    11566    4888 57.7% 12-Jan-98 04:39:32 +source.html
  183.     2633    1229 53.3% 12-Jan-98 04:39:36 +teutsch.html
  184.     3810    1719 54.8% 12-Jan-98 04:39:44 +undocumented.html
  185.     4059    1809 55.4% 12-Jan-98 04:40:30 +updates.html
  186.    14426    5984 58.5% 12-Jan-98 05:34:28 +usecases.html
  187.      628     278 55.7% 08-Jun-97 10:44:16 +examples.info
  188.      628     273 56.5% 08-Jun-97 10:44:16 +advanced.info
  189.      200     132 34.0% 03-Jun-97 03:59:10 +README
  190.      463     239 48.3% 03-Jun-97 03:00:22 +README.info
  191.      628     271 56.8% 08-Jun-97 10:44:16 +fetzenschaedl.info
  192.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  193.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  194.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  195.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  196.      583     296 49.2% 07-Jan-98 08:37:42 +Makefile
  197.     2497    1168 53.2% 03-Jun-97 03:51:46 +README
  198.      463     238 48.5% 03-Jun-97 03:00:22 +README.info
  199.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  200.      628     274 56.3% 08-Jun-97 10:44:16 +simple.info
  201.       55      55  0.0% 09-Mar-97 21:33:14 +